home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 081 / badusr12.arc / BADUSER.DOC < prev    next >
Text File  |  1987-07-13  |  8KB  |  253 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                    BADUSER
  9.  
  10.  
  11.  
  12.                                     v1.20
  13.  
  14.  
  15.  
  16.                        Copyright(c) 1987 by Greg Dawson
  17.  
  18.                              ShutterBUG (106/111)
  19.                                 (713)880-4329
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.        ---------------------------------------------------------------
  66.        INTRODUCTION...
  67.        ---------------------------------------------------------------
  68.  
  69.        I was inspired (or forced) into writing this simple program due
  70.        the bombardments of  one persistant little  dweeb.  As a former
  71.        RBBS sysop, I missed  the one feature that checked a users name
  72.        against the contents of a file  called "TRASHCAN.".  Need I say
  73.        more?  So here it is, a small, but  useful program that filters
  74.        out all those #$%@!%  that slither  their way into our peaceful
  75.        environment.  (Ahheemm)
  76.  
  77.  
  78.  
  79.        ----------------------------------------------------------------
  80.        COMMAND USAGE (Don't skip this part)...
  81.        ----------------------------------------------------------------
  82.        The command line syntax is as follows...
  83.  
  84.         BADUSER -b -o -p -c -l -d -s
  85.  
  86.            -b  <== Turns on the alarm.
  87.            -o  <== Path and file to display if the user is Ok.
  88.            -p  <== Path to the BADUSER support files.
  89.            -c  <== Control character(s) to display if user Ok.
  90.            -l  <== Enable last user display.
  91.            -d1 <== Lower/Raise DTR to drop user (Port 1 or 2).
  92.            -s  <== Sysops name.
  93.  
  94.       A typical command line might go as follows...
  95.  
  96.       BADUSER  -d1 -b -l -sGreg Dawson -oC:\opus\misc\welcome2 -pC:\opus\
  97.  
  98.  
  99.       ----------------------------------------------------------------
  100.       THE SUPPORT FILES (Don't skip this either)...
  101.       ----------------------------------------------------------------
  102.  
  103.       Here's a list what you should of recieved in "BADUSR12.ARC".
  104.  
  105.         WELCOME .BBS            A sample OPUS welcome file.
  106.         WELCOMEB.???            A sample welcome file chained by BADUSER.
  107.         BADUSER .COM            The Command file.
  108.         BADUSER .DAT            The "Trashcan" file, if you may.
  109.         BADUSER .DOC            The Documentation.
  110.         BAD     .BAT            The Batch file to invoke BADUSER.COM
  111.         README                  For a quick installation.
  112.  
  113.       ----------------------------------------------------------------
  114.  
  115.  
  116.        WELCOME.BBS
  117.        ------------
  118.        This file is the  critical link  between  BADUSER and the outside
  119.        world.  You may modify it to your needs, but it should contain all
  120.        of the following commands, in this order...
  121.  
  122.           ^B                         <= Disable ^C or ^K aborting.
  123.           ^OC\OPUS\MISC\BAD          <= Invoke the BAD.BAT file.
  124.           ^OS\OPUS\MISC\BADUSER      <= Display the .BBS or .GBS file.
  125.  
  126.  
  127.        WELCOMEB.BBS and .GBS
  128.        ---------------------
  129.        These are sample welcome files.  Modify them accordingly.
  130.  
  131.  
  132.         BADUSER.DAT
  133.         -----------
  134.         All the entries must be followed by a "," after the word.
  135.         Example...
  136.  
  137.           Destructor,           <= Is a valid name.
  138.           Destructor            <= Is not valid due to the lack of ",".
  139.  
  140.         Important: Leave a blank line at the end of the file.
  141.  
  142.  
  143.  
  144.         BADUSER.DOC
  145.         -----------
  146.         Your reading it.
  147.  
  148.  
  149.  
  150.         BADUSER.BBS or .GBS
  151.         -------------------
  152.         This is a file  BADUSER.COM creates  with the information that
  153.         determines fate of the  user.  If the user is ok, it will contain
  154.         the  command to chain whatever file you want to. If the user didn't
  155.         pass (and you don't have the -d switch on), the prompt "Access Denied"
  156.         followed by a mysterious loss of the carrier will result.  If the -d
  157.         switch is on, the DTR will be instantly dropped, along with the
  158.         'Baduser'.
  159.  
  160.         You definately don't have to worry about this file.
  161.  
  162.  
  163.          LASTUSER.DAT
  164.          ------------
  165.          If you choose to display who last used the system (-l option),
  166.          this file will contain such information.  Use the -s option to
  167.          exclude a specific name (sysop) from being recorded. By doing
  168.          this, nobody will ever see your name as being the last user.
  169.  
  170.          One more thing, when using this option for the first time, log
  171.          on with a name other than your own.  By doing this you'll write
  172.          that name to LASTUSER.DAT, otherwise no name will be written until
  173.          someone calls for the first time.  Meaning, that first caller
  174.          otherwise will not get a "... was the previous caller".
  175.  
  176.          I don't really know how to explain it other than that, so to
  177.          put it simply, don't worry about it.  After that initial caller,
  178.          you'll be A-Ok.
  179.  
  180.  
  181.         ---------------------------------------------------------------
  182.         INSTALLING IT...
  183.         ---------------------------------------------------------------
  184.  
  185.         Here's what to do:
  186.  
  187.           1.  Rename your WELCOME.??? files to WELCOME2.???.
  188.  
  189.           2.  UnARC everything contained in BADUSR12.ARC into your
  190.               \OPUS\MISC\  directory.
  191.  
  192.           3.  Edit BAD.BAT to your name after the "-s" switch.
  193.  
  194.           4.  Log on with a name other than your own to initialize
  195.               the LASTUSER.DAT file.
  196.  
  197.         That's it!
  198.  
  199.  
  200.         COMBINATIONS...
  201.         ---------------
  202.         There's a few combinations of welcome files in OPUS, i.e.
  203.         Newuser1, Newuser2, and Rookie.  You'll have to experiment with
  204.         these yourself.  The configuration discussed above uses only
  205.         the opus .CTL file command "Uses welcome".
  206.  
  207.  
  208.         ----------------------------------------------------------------
  209.         A WORD ABOUT v1.20...
  210.         ----------------------------------------------------------------
  211.         In previous version of the program, you were required to post
  212.         the users name to an answer file.  This is no longer nesessary.
  213.         BADUSER will get all of it's info from a file called LASTUSER.BBS,
  214.         which is created by Opus in it's root directory every time a user
  215.         goes outside.
  216.  
  217.         The -l option will enable diplaying of the last user, along with
  218.         a freindly greeting (I.E. "Good morning...").  Use the -s option
  219.         to exclude your name from being the last user.  There's been some
  220.         work done to properly format the users city/state.  For example,
  221.         the program will take "houston,tx" and turn it into "Houston, TX".
  222.         No big deal, it just *looks* better.
  223.  
  224.         The -d option will lower and raise the DTR to drop the user, it's
  225.         a more assured way of getting the job done.  Otherwise the command
  226.         ^F^N in BADUSER.BBS and .GBS files will do the work.
  227.  
  228.         A new style "wooping" alarm was added.  This uses BASIC's SOUND
  229.         statements and might not give the desired effect on some
  230.         compatables.
  231.  
  232.         Oh yea, all the "/" switches are now "-".
  233.  
  234.  
  235.         ---------------------------------------------------------------
  236.         A WORD OF MEMORY...
  237.         ---------------------------------------------------------------
  238.         Since BADUSER is written in compiled BASIC, it's a little bit of
  239.         a memory hog.  When running DoubleDOS, I find that 280K seems to
  240.         be plenty for Opus (v0.00) and BADUSER.
  241.  
  242.  
  243.         ---------------------------------------------------------------
  244.         IMPORTANT NOTICE...
  245.         ---------------------------------------------------------------
  246.         This program is strictly public domain.  You may not accept any
  247.         form of payment for it, private, commercial or otherwise.  Feel
  248.         free to post this software on any bulletin board system.  The
  249.         program is distributed "as is".  The author shall not be liable
  250.         for any damage caused by this program. You should only run this
  251.         software upon the agreement of all of the above items.
  252.  
  253.